home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / rzsz0916.zip / SZ.DOC < prev    next >
Text File  |  1996-06-28  |  25KB  |  595 lines
  1.  
  2.  
  3.  
  4.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       sx, sb, sz - Send Files with ZMODEM, YMODEM, or XMODEM
  10.       zcommand, zcommandi -    Send Commands with ZMODEM
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       sz [-++++aaaabbbbddddeeeeffffkkkkLLLLllllNNNNnnnnooooppppttttuuuuvvvvxxxxyyyyYYYYZZZZ] _f_i_l_e ...
  14.       sb [-ddddffffkkkkttttuuuuvvvv] _f_i_l_e ...
  15.       sx [-kkkkttttuuuuvvvv] _f_i_l_e
  16.       zcommand [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
  17.       zcommandi [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
  18.       sz -T
  19.  
  20.  
  21.      LLLLIIIICCCCEEEENNNNSSSSEEEE AAAAGGGGRRRREEEEEEEEMMMMEEEENNNNTTTT
  22.       This is a copyrighted    shareware program.  Commercial use of
  23.       this program is subject to licensing conditions detailed in
  24.       the rz.c source code.     "Commercial Use" includes any use of
  25.       this program to send files to    a commercial or    shareware
  26.       program not published    or licensed by Omen Technology INC.
  27.  
  28.       Registration information is provided in the file mailer.rz.
  29.  
  30.       Use of this program constitutes agreement to the License
  31.       Agreement.
  32.  
  33.      SSSSUUUUPPPPPPPPOOOORRRRTTTT
  34.       Users    who have not purchased support may dial    900-555-7836
  35.       (900-555-RTFM) for technical assistance.  There is a charge
  36.       of $4.69 per minute to use this support line.     Callers must
  37.       be 18    years or older.
  38.  
  39.       Registered users encountering    problems using this program on
  40.       standard serial ports    to transfer files with Professional-
  41.       YAM or ZCOMM may call    the support number listed in the
  42.       Professional-YAM/ZCOMM documentation.     Solutions to nearly
  43.       all file transfer problems are described in the
  44.       Professional-YAM/ZCOMM documentation.
  45.  
  46.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.       SSSSzzzz (send ZMODEM) uses    the ZMODEM, YMODEM or XMODEM error
  48.       correcting protocol to send one or more files    over a dial-in
  49.       serial port to a variety of programs running under PC-DOS,
  50.       CP/M,    Unix, VMS, and other operating systems.
  51.  
  52.       To obtain the    maximum    performance and    full functionality of
  53.       this program we recommend its    use with GSZ, Professional-YAM
  54.       or ZCOMM.
  55.  
  56.       This program is intended to act as a server for terminal
  57.       programs, not    to act as one.    This program is    not designed
  58.       to be    called from _c_u(_1) _t_i_p(_1), or other communications
  59.       programs.  Unix flavors of Omen Technology's Professional-
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 6/28/96)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       YAM communications software are available for    dial-out
  75.       applications.     Unix Professional-YAM supports    dial-out
  76.       applications with telephone directory, a powerful script
  77.       language with    learn function,    high quality multiple protocol
  78.       support, and UUCP port arbitration.
  79.  
  80.       SSSSzzzz sends one or more files with ZMODEM protocol.
  81.  
  82.       ZMODEM greatly simplifies file transfers compared to XMODEM.
  83.       In addition to a friendly user interface, ZMODEM provides
  84.       Personal Computer and    other users an efficient, accurate,
  85.       and robust file transfer method.
  86.  
  87.       ZMODEM provides complete EEEENNNNDDDD----TTTTOOOO----EEEENNNNDDDD data integrity between
  88.       application programs.     ZMODEM's 32 bit CRC catches errors
  89.       that sneak into even the most    advanced networks.
  90.  
  91.       Advanced file    management features include AutoDownload
  92.       (Automatic file Download initiated without user
  93.       intervention), Display of individual and total file lengths
  94.       and transmission time    estimates, Crash Recovery, selective
  95.       file transfers, and preservation of exact file date and
  96.       length.
  97.  
  98.       The ----yyyy option    instructs the receiver to open the file    for
  99.       writing unconditionally.  The    ----aaaa option causes the receiver
  100.       to convert Unix newlines to PC-DOS carriage returns and
  101.       linefeeds.
  102.  
  103.  
  104.       SSSSbbbb sends one or more files with YMODEM or ZMODEM protocol.
  105.       The initial ZMODEM initialization is not sent.  When
  106.       requested by the receiver, ssssbbbb    supports YYYYMMMMOOOODDDDEEEEMMMM----gggg with
  107.       "cbreak" tty mode, XON/XOFF flow control, and    interrupt
  108.       character set    to CAN (^X).  YYYYMMMMOOOODDDDEEEEMMMM----gggg (Professional-YAM gggg
  109.       option) increases YMODEM throughput over error free channels
  110.       (direct connection, X.PC, etc.) by disabling error recovery.
  111.  
  112.       On Unix systems, additional information about    the file is
  113.       transmitted.    If the receiving program uses this
  114.       information, the transmitted file length controls the    exact
  115.       number of bytes written to the output    dataset, and the
  116.       modify time and file mode are    set accordingly.
  117.  
  118.  
  119.       SSSSxxxx sends a single _f_i_l_e with XXXXMMMMOOOODDDDEEEEMMMM or    XXXXMMMMOOOODDDDEEEEMMMM----1111kkkk protocol
  120.       (sometimes incorrectly called    "ymodem").  The    user must
  121.       supply the file name to both sending and receiving programs.
  122.  
  123.       Iff sssszzzz is invoked with $SHELL    set and    iff that variable
  124.       contains the string _r_s_h or _r_k_s_h (restricted shell), sssszzzz
  125.       operates in restricted mode.    Restricted mode    restricts
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 6/28/96)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       pathnames to the current directory and PUBDIR    (usually
  141.       /usr/spool/uucppublic) and/or    subdirectories thereof.
  142.  
  143.  
  144.       The fourth form sends    a single COMMAND to a ZMODEM receiver
  145.       for execution.  ZZZZccccoooommmmmmmmaaaannnndddd exits with the COMMAND return
  146.       value.  If COMMAND includes spaces or    characters special to
  147.       the shell, it    must be    quoted.
  148.  
  149.  
  150.       The fifth form sends a single    COMMAND    to a ZMODEM receiver
  151.       for execution.  ZZZZccccoooommmmmmmmaaaannnnddddiiii exits as soon as the receiver has
  152.       correctly received the command, before it is executed.
  153.  
  154.  
  155.       The sixth form (sz -T) outputs all 256 code combinations to
  156.       the terminal.     The hex value of the character, a space, and
  157.       the raw character are    sent, 8    per line.  In you are having
  158.       difficulty sending files, this command lets you see which
  159.       character codes are being eaten by the operating system or
  160.       network.  The    terminal program must be set to    display    all
  161.       256 codes in a distinct form.     Check that each code is sent,
  162.       and that the 8th bit on codes    0x80 to    0xFF is    set.
  163.  
  164.       Sz -T    then allows the    caller to input    characters which are
  165.       echoed in hex.  You should check that    all control characters
  166.       can be input this way.
  167.  
  168.  
  169.  
  170.       The meanings of the available    options    are:
  171.  
  172.       ++++    Instruct    the receiver to    append transmitted data    to an
  173.            existing    file (ZMODEM only).
  174.       aaaa    Instruct    the ZMODEM receiver to convert text file
  175.            format as appropriate for the receiving system.    Valid
  176.            only for    ZMODEM.
  177.       bbbb    (ZMODEM)    Binary override: transfer file without any
  178.            translation.
  179.       cccc    Instruct    the receiver to    change the pathname if the
  180.            destination file    exists.
  181.       dddd    Change all instances of "." to "/" in the transmitted
  182.            pathname.  Thus,    C.omenB0000 (which is unacceptable to
  183.            MSDOS or    CP/M) is transmitted as    C/omenB0000.  If the
  184.            resultant filename has more than    8 characters in    the
  185.            stem, a "." is inserted to allow    a total    of eleven.
  186.       eeee    Escape all control characters and the all ones
  187.            character (0xFF); normally only XON, XOFF, and Ctrl-X
  188.            are escaped.
  189.       ffff    Send Full pathname.  Normally directory prefixes    are
  190.            stripped    from the transmitted filename.
  191.       gggg    Send ESC-[-?-3-4-l to start DSZ from Kermit.
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 6/28/96)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.       kkkk    (XMODEM/YMODEM) Send files using    1024 byte blocks
  207.            rather than the default 128 byte    blocks.     1024 byte
  208.            packets speed file transfers at high bit    rates.
  209.            (ZMODEM streams the data    for the    best possible
  210.            throughput.)
  211.       LLLLNNNN   Use ZMODEM sub-packets of length    N.  A larger N (32 <=
  212.            N <= 1024) gives    slightly higher    throughput, a smaller
  213.            N speeds    error recovery.     The default is    128 below 300
  214.            baud, 256 above 300 baud, or 1024 above 2400 baud.
  215.       llllNNNN   Wait for    the receiver to    acknowledge correct data every
  216.            NNNN (32 <=    N) characters.    This may be used to avoid
  217.            network overrun when XOFF flow control is lacking.
  218.       nnnn    (ZMODEM)    Send each file if destination file does    not
  219.            exist.  Overwrite destination file if source file is
  220.            newer than the destination file.
  221.       NNNN    (ZMODEM)    Send each file if destination file does    not
  222.            exist.  Overwrite destination file if source file is
  223.            newer or    longer than the    destination file.
  224.       oooo    (ZMODEM)    Disable    automatic selection of 32 bit CRC.
  225.       pppp    (ZMODEM)    Protect    existing destination files by skipping
  226.            transfer    if the destination file    exists.
  227.       rrrr    (ZMODEM)    Resume interrupted file    transfer.  If the
  228.            source file is longer than the destination file,    the
  229.            transfer    commences at the offset    in the source file
  230.            that equals the length of the destination file.
  231.       rrrrrrrr   As above, but compares the files    (the portion common to
  232.            sender and receiver) before resuming the    transfer.
  233.       ttttttttiiiimmmm Change timeout to _t_i_m tenths of seconds.
  234.       uuuu    Unlink the file after successful    transmission.  Users
  235.            should not manually abort or skip file transfers    when
  236.            this option is used.
  237.       wwwwNNNN   Limit the transmit window size to N bytes (ZMODEM).
  238.       vvvv    Verbose causes a    list of    file names to be appended to
  239.            /tmp/szlog .  More v's generate more output.
  240.       xxxx    Count skipped files as errors.
  241.       yyyy    Instruct    a ZMODEM receiving program to overwrite    any
  242.            existing    file with the same name.
  243.       YYYY    Instruct    a ZMODEM receiving program to overwrite    any
  244.            existing    file with the same name, and to    skip any
  245.            source files that do have a file    with the same pathname
  246.            on the destination system.
  247.       ZZZZ    Use ZMODEM file compression to speed file transfer.
  248.  
  249.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  250.       Exit status is as follows: 0 for successful transfers.  1 if
  251.       unrecoverable    errors are detected.  2    if syntax errors or
  252.       file access problems are detected.  3    if the program was
  253.       terminated by    a caught interrupt.
  254.  
  255.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 6/28/96)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  269.  
  270.  
  271.  
  272.       ZZZZMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    DSZ/ZCOMM/Professional-YAM)
  273.       %%%% sssszzzz ----aaaa ****....cccc
  274.       This single command transfers    all .c files in    the current
  275.       Unix directory with conversion (----aaaa) to end of    line
  276.       conventions appropriate to the receiving environment.     With
  277.       ZMODEM AutoDownload enabled, Professional-YAM     and ZCOMM
  278.       will automatically receive the files after performing    a
  279.       security check.
  280.  
  281.       %%%% sssszzzz ----YYYYaaaannnn ****....cccc    ****....hhhh
  282.       Send only the    .c and .h files    that exist on both systems,
  283.       and are newer    on the sending system than the corresponding
  284.       version on the receiving system, converting Unix to DOS text
  285.       format.
  286.  
  287.       ZZZZMMMMOOOODDDDEEEEMMMM CCCCoooommmmmmmmaaaannnndddd DDDDoooowwwwnnnnllllooooaaaadddd (Unix    to Professional-YAM)
  288.        cpszall:all
  289.           zcommand "c:;cd /yam/dist"
  290.           sz -ya $(YD)/*.me
  291.           sz -yb y*.exe
  292.           zcommand "cd /yam"
  293.           zcommandi    "!insms"
  294.       This Makefile    fragment uses zzzzccccoooommmmmmmmaaaannnndddd to issue    commands to
  295.       Professional-YAM to change current disk and directory.
  296.       Next,    sssszzzz transfers the ._m_e files from    the $YD    directory,
  297.       commanding the receiver to overwrite the old files and to
  298.       convert from Unix end    of line    conventions to PC-DOS
  299.       conventions.    The third line transfers some ._e_x_e files.  The
  300.       fourth and fifth lines command Pro-YAM to change directory
  301.       and execute a    PC-DOS batch file _i_n_s_m_s    . Since    the batch file
  302.       takes    considerable time, the zzzzccccoooommmmmmmmaaaannnnddddiiii form is used to allow
  303.       the program to exit immediately.
  304.  
  305.       XXXXMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    Crosstalk)
  306.       % ssssxxxx ffffoooooooo....cccc
  307.       EEEESSSSCCCC
  308.       rrrrxxxx ffffoooooooo....cccc
  309.       The above three commands transfer a single file from Unix to
  310.       a PC and Crosstalk.  This combination    is much    slower and
  311.       less reliable    than ZMODEM.
  312.  
  313.      EEEERRRRRRRROOOORRRR MMMMEEEESSSSSSSSAAAAGGGGEEEESSSS
  314.       "Caught signal 99" indicates the program was not properly
  315.       compiled, refer to "bibi(99)"    in rbsb.c for details.
  316.  
  317.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  318.       rz(omen), ZCOMM User's Manual, Professional-YAM User's
  319.       Manual, crc(omen), sq(omen), todos(omen), tocpm(omen),
  320.       tomac(omen), yam(omen)
  321.  
  322.       Compile time options required    for various operating systems
  323.       are described    in the source file.
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 6/28/96)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  335.  
  336.  
  337.  
  338.      FFFFIIIILLLLEEEESSSS
  339.       32 bit CRC code courtesy Gary    S. Brown.
  340.  
  341.       sz.c,    crctab.c, rbsb.c, zm.c,    zmr.c, zmodem.h    Unix source
  342.       files
  343.  
  344.       /tmp/szlog stores debugging output (sz -vv)
  345.  
  346.      TTTTEEEESSSSTTTTIIIINNNNGGGG FFFFEEEEAAAATTTTUUUURRRREEEE
  347.       The command "sz -T file" exercises the AAAAttttttttnnnn sequence error
  348.       recovery by commanding errors    with unterminated packets.
  349.       The receiving    program    should complain    five times about
  350.       binary data packets being too    long.  Each time sssszzzz is
  351.       interrupted, it should send a    ZDATA header followed by
  352.       another defective packet.  If    the receiver does not detect
  353.       five long data packets, the AAAAttttttttnnnn sequence is not
  354.       interrupting the sender, and the MMMMyyyyaaaattttttttnnnn string in sssszzzz....cccc must
  355.       be modified.
  356.  
  357.       After    5 packets, sssszzzz stops the    "transfer" and prints the
  358.       total    number of characters "sent" (Tcount).  The difference
  359.       between Tcount and 5120 represents the number    of characters
  360.       stored in various buffers when the Attn sequence is
  361.       generated.
  362.  
  363.      SSSSEEEERRRRVVVVEEEERRRR////NNNNEEEETTTTWWWWOOOORRRRKKKK NNNNOOOOTTTTEEEESSSS
  364.       Terminals on some timesharing    systems    are connected
  365.       indirectly to    the host with TTTTEEEERRRRMMMMIIIINNNNAAAALLLL SSSSEEEERRRRVVVVEEEERRRRSSSS operating over
  366.       networks.  Terminal servers often interfere with file
  367.       transfers by "eating"    control    characters and/or losing data.
  368.  
  369.       Accessing a distant system using tttteeeellllnnnneeeetttt on a local Unix
  370.       system entails the same problems.  If    tttteeeellllnnnneeeetttt does not    work
  371.       well,    try rrrrllllooooggggiiiinnnn with    the ----8888 option.    Set the    escape
  372.       character to ^P (control P) which is protected by ZMODEM.
  373.  
  374.       When terminal    servers    interfere with file transfers, server
  375.       commands are often available to help the problem.  When
  376.       possible, enable the server and modems for hardware flow
  377.       control in and out.  Set the terminal    server to telnet
  378.       transparent mode.  Some typical commands are "SET TERMINAL
  379.       DOWNLOAD", "set session passall", and    "SET TERMINAL NO ESC",
  380.       but there is no standard set of commands suitable for    all
  381.       terminal servers.  Normally these commands are given before
  382.       attempting file transfers, but one user has reported that
  383.       the command must be given _a_f_t_e_r the file transfer is
  384.       started(!).  Until terminal server vendors improve the
  385.       quality of their product, you    may have to get    on their case
  386.       until    they adequately    support    high performance file
  387.       transfers.
  388.  
  389.       The telnet protcol used by the _t_e_l_n_e_t    program    and terminal
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 6/28/96)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  401.  
  402.  
  403.  
  404.       servers uses 0xFF (377 octal)    for special control functions.
  405.       The 0xFF character may cause problems    if it appears in the
  406.       data stream, especially uploading at high speeds.  With
  407.       ZCOMM    or Professional-YAM the    0xFF character can be
  408.       protected by giving the command:
  409.       set zmtxesc ?
  410.  
  411.       Escaping control characters with ZMODEM (sz -e) may help if
  412.       the transfer gets stuck in the same place on every attempt.
  413.       Professional-YAM and ZCOMM allow selection of    which control
  414.       characters need to be    escaped.  In extreme cases 7-bit
  415.       transmission may be required (see the    Professional-YAM/ZCOMM
  416.       manual).  If you encounter problems with control characters
  417.       you should identify which control characters are causing the
  418.       problem.  Please refer to the    sz -T command in sz.doc    for
  419.       more help.
  420.  
  421.       Flow control between the server and modem is often
  422.       defective.  This rarely causes a problem in interactive
  423.       applications whose short bursts (a screenfull    at most) fit
  424.       within the available memory buffers.    Streaming protocols
  425.       such as YMODEM-g, long packet    SuperKermit, and ZMODEM    can
  426.       overload the available buffering.  Some terminal servers
  427.       support commands to enable hardware flow control such    as
  428.       "TERM    FLOWCONTROL HARDWARE IN    OUT"; this assumes the modem
  429.       attached to the server is properly configured.
  430.  
  431.       If the terminal server is too    brain damaged to support flow
  432.       control, ZMODEM lets you fake    it by setting a    window size.
  433.       Try
  434.            sz -w2048 file...
  435.       to enable software flow control.  Experiment with different
  436.       window sizes for best    results.
  437.  
  438.       Terminal servers are designed    to accept keyboard input from
  439.       human    operators.  They may lose data when a program sends
  440.       more data to the host    faster than humans type.  Some servers
  441.       allow    larger input buffers to    support    file uploads.  If you
  442.       can upload short files (less than 100    bytes) but not longer
  443.       files, try
  444.            sz -w1024 file...
  445.       with your uploading program.    (Not all programs support this
  446.       option; use ZCOMM or Professional-YAM.)
  447.  
  448.       When both flow control and character transparency are
  449.       problems, use
  450.            sz -ew1024 file...
  451.       as a starting    point.
  452.  
  453.       Sometimes the    terminal server    software is defective and must
  454.       be corrected.     Please    contact    the network's vendor for
  455.       corrective procedures.  An alternative is to install direct
  456.  
  457.  
  458.  
  459.      Page 7                         (printed 6/28/96)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  467.  
  468.  
  469.  
  470.       serial ports for users desiring to upload files.
  471.  
  472.       We have also encountered problems when networking software
  473.       fails    to pass    data after a large amount of data has been
  474.       sent to the host.  This has happened on a PPP    internet
  475.       connection which prevented uploads of    large amounts of data
  476.       via either FTP or a ZMODEM upload (via TELNET).  The PPP
  477.       connection grinds to a standstill and    not even PING works.
  478.       The same ZMODEM/TELNET combination easily uploaded ten times
  479.       as much to a nearby machine connected    by Ethernet.
  480.  
  481.  
  482.      PPPPOOOORRRRTTTT WWWWAAAATTTTCCCCHHHHEEEERRRRSSSS
  483.       Some systems enforce a timeout which disconnects a user
  484.       after    several    minutes    of keyboard inactivity.     Long, error
  485.       free ZMODEM transfers    do not generate    keyboard activity
  486.       (this    is why ZMODEM is so efficient).     Restricting the
  487.       window size with
  488.            sz -w16384 file...
  489.       option generates terminal input at regular intervals even
  490.       when no error    correction is needed.  If problems persist,
  491.       try setting a    packet length.
  492.            sz -l1024 file...
  493.       (The default ZMODEM packet length is the file    length.)
  494.  
  495.      NNNNOOOOTTTTEEEESSSS
  496.       SSSSzzzz is    now compiled with internal buffering to    allow sending
  497.       datasets piped to its    standard input.
  498.            ps -ef |    sz -
  499.       The file is sent as "szPID" where PID    is the process ID of
  500.       sending sz.
  501.  
  502.       Particular attention must be paid to flow control.  The
  503.       modem    and Unix must agree on the flow    control    method.     Sz
  504.       does not set or reset    flow control modes (if any).  Most
  505.       Unix systems use XON/XOFF ("software") flow control.
  506.  
  507.       Telebit modems must not be set to "spoof" UUCP, XMODEM,
  508.       YMODEM, or KERMIT.  Setting one of these spoofing modes
  509.       interferes with other    protocols.  Telebit's YMODEM spoofing
  510.       interferes with YMODEM transfers.
  511.  
  512.       If a program that does not properly implement    the specified
  513.       file transfer    protocol causes    _s_b to "hang" the port after a
  514.       failed transfer, either wait for _s_b to time out or keyboard
  515.       a dozen Ctrl-X characters.  Every reported instance of this
  516.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  517.       other    program    with a correct implementation of the specified
  518.       protocol.
  519.  
  520.       Many programs    claiming to support YMODEM only    support    XMODEM
  521.       with 1k blocks, and they often don't get that    quite right.
  522.  
  523.  
  524.  
  525.      Page 8                         (printed 6/28/96)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  533.  
  534.  
  535.  
  536.       XMODEM transfers add up to 127 garbage bytes per file.
  537.       XMODEM-1k and    YMODEM-1k transfers use    128 byte blocks    to
  538.       avoid    extra padding.
  539.  
  540.       YMODEM programs use the file length transmitted at the
  541.       beginning of the transfer to prune the file to the correct
  542.       length; this may cause problems with source files that grow
  543.       during the course of the transfer.  This problem does    not
  544.       pertain to ZMODEM transfers, which preserve the exact    file
  545.       length unconditionally.
  546.  
  547.       Most ZMODEM options are merely passed    to the receiving
  548.       program; some    programs do not    implement all of these
  549.       options.
  550.  
  551.       Circular buffering and a ZMODEM sliding window should    be
  552.       used when input is from pipes    instead    of acknowledging
  553.       frames each 1024 bytes.  If no files can be opened, sssszzzz sends
  554.       a ZMODEM command to echo a suitable complaint; perhaps it
  555.       should check for the presence    of at least one    accessible
  556.       file before getting hot and bothered.
  557.  
  558.       Unix Professional-YAM    provides higher    performance and    other
  559.       features not supported by _s_z.    Please contact Omen Technology
  560.       Inc for product information.
  561.  
  562.       Omen Technology INC
  563.       Post Office Box 4681
  564.       Portland OR 97208
  565.       503-614-0430 (Sales)
  566.       900-555-RTFM (Non-Customer Technical Support)
  567.  
  568.  
  569.      BBBBUUUUGGGGSSSS
  570.       On at    least one BSD system, sz would abend it    got within a
  571.       few kilobytes    of the end of file.
  572.       Using    the "-w8192" option fixed the problem.    The real cause
  573.       is unknown, perhaps a    bug in the kernel TTY output routines.
  574.  
  575.       The test mode    leaves a zero length file on the receiving
  576.       system.
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                         (printed 6/28/96)
  592.  
  593.  
  594.  
  595.